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1. Preface 

The User's Document associated with the Sun-2/50 Video Board Diagnostic is presented. 

1.1. Purpose 

It is the intention of this document to inform the reader how to use the Sun-2/50 Video 
Board Diagnostic. The command line syntax for each menu option (test) is presented and 
explained. 



1.2. Audience 

Members of any of the following five departments may find this document of interest for 
various reasons: Design Engineering, Manufacturing, Field Service, Diagnostics and Documenta- 
tion. 

Using the Sun-2/50 Video Board Diagnostic, the Design Engineers) of the Sun-2/50 Video 
Board can confirm the correctness of their design. Manufacturing and Field Service personnel 
can use the Sun-2/50 Video Board Diagnostic for testing and/or trouble shooting purposes. 
Members) of the Diagnostic department can review the design of the Sun-2/50 Video Board 
Diagnostic based on this document. Finally, Documentation can use this document as a basis for 
developing the User's Guide which is shipped with the product itself. 

At a minimum, the reader is assumed to have some understanding of the function of the 
Sun-2/50 Video Board. An excellent preface to this document is "Engineering Manual Sun-2 
Model 50". Another relevant document is titled "Sun-2/50 Video Board Diagnostic Design Docu- 
ment". 



2. Revision History 

Revision A August 5, 1985 Initial release of this document. 

3. Glossary 

CPU - Central Processing Unit 

FRU - Field Replaceable Unit 

ROM - Read Only Memory 

SCC - Serial Communication Controller 

SCSI - Small Computer System Interface 
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4. Introduction 

The Sun-2/50 Video Board is the display subsystem for the Sun-2 products which use VME 
Bus. It has a serial interface with the monitor, keyboard and mouse in addition to a parallel 
interface with the CPU board. As a part of the video board, a control register enables several 
advanced features such as copy mode and interrupts. 

The Sun-2/50 Video Board Diagnostic was designed to test the Sun-2/50 Video Board. The 
Sun-2/50 Video Board consists of the following three sections: the control register, serial com- 
munication controller and video memory. All three sections of the Sun-2/50 Video Board can be 
tested by the Sun-2/50 Video Board Diagnostic. 

5. Problem Specification 

Generally speaking, the objective of the Sun-2/50 Video Board Diagnostic to ensure that the 
Sun-2/50 Video Board works correctly. In this case, "works correctly" implies that the Sun-2/50 
Video Board functions as stated in the "Engineering Manual Sun-2 Model 50". 

Again, the three functional sections of the Sun-2/50 Video Board are the control register, 
serial communication controller and video memory. The Sun-2/50 Video Board Diagnostic tests 
all three of these functional sections. 

In particular, the memorability and functionality of the Sun-2/50 Video Board's control 
register are tested. The functionality of the serial communication controller is checked. Finally, 
the Sun-2/50 Video Board Diagnostic tests the memorability of video memory. 

6. Requirements 

In order to run the Sun-2/50 Video Board Diagnostic, the following hardware, software and 
firmware requirements must be met. 



6.1. Hardware Requirements 

The minimum hardware configuration required is listed below. 

1. A Sun-2/50 board. 

2. A Sun-2/50 power supply. 

3. A dumb terminal (TeleVideo, Wyse, etc.), attached to one of the CPU serial ports, is 
required for board test (not system test). 

4. A boot device (i.e. local disk, local tape or_iejaote disk via ethernet). 

5. A Sun-2/50 Video Monitor. 
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6.2. Software Requirements 

An executable version of the Sun-2/50 Video Board Diagnostic is to be used for testing 
and/or trouble shooting of the Sun-2/50 Video Board. The name of the relevant executable file 
is: "video50.diag". 



6.3. Firmware Requirements 

The standard power-up diagnostic/monitor/boot ROM is needed. The power-up diagnostic 
performs a limite,d "crawl out" test. It is also used to load and begin execution of the Sun-2/50 
Video Board Diagnostic. 

7. Operating Instructions 

The sections below describe how to load and operate the Sun-2/50 Video Board Diagnostic. 
Specifically, instructions for loading and beginning execution of the Sun-2/50 Video Board Diag- 
nostic are covered in the section titled: "Loading And Starting". Operating instructions are dis- 
cussed in the section titled: "The User Interface". 



7.1. Loading And Starting 

The following steps must be followed in the order listed below to run the Sun-2/50 Video 
Board Diagnostic. 

1. Turn on the system. 

2. After the system has been turned on, the power-up ROM diagnostics perform a "crawl 
out" test of the system before automatically booting UNIX. Since the Sun-2/50 Video 
Board Diagnostic is a stand alone diagnostic, UNIX should not be booted. The user 
should, therefore, terminate the process of booting UNIX. If the user is interacting with 
the Sun-2 console, this can be done by typing "Ll-a". That is, hold down the "Ll" key 
while pressing the "a" key. On the other hand, if the user is interacting with the Sun- 
2/50 Video Board Diagnostic via a dumb terminal, the booting of UNIX can be ter- 
minated by pressing the "break" key. 

3. In order to reset the memory maps to their initial state, the following two keys should be 
typed prior to pressing the "return" key: "kl". Notice that the Sun-2/50 Video Board 
Diagnostic cannot be booted correctly if this reset step is skipped. 

4. At this point the Sun-2/50 Video Board Diagnostic can be loaded and its execution 
started. The three ways to load the Sun-2/50 Video Board Diagnostic are listed below. 

A. Assuming that the executable version of the Sun-2/50 Video Board Diagnostic, 
"video50.diag", resides on the machines local disk in directory "/pub/stand" or 
"/stand", the diagnostic can be loaded by typing the following command line before 
pressing the "return" key. 

"b stand/video50.diag" 
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B. If the Sun-2/50 Video Board Diagnostic resides on a remote disk, it can be loaded 
via ethernet. Assuming that the network file server has a partition reserved for the 
system being tested (i.e. the system under test is a client of the file server) and that 
"video50.diag" resides in the file server's directory "/pub/stand", tne Sun-2/50 Video 
Board Diagnostic can be loaded by entering the following command line before 
pressing the "return" key. 

"b ec(,<file_server_host_net_number>)stand/video50.diag" 

C. Finally, the Sun-2/50 Video Board Diagnostic can be loaded from local tape. 
Assuming that the tape contains a bootable image of "video50.diag", the three com- 
mand lines listed below can be used to load the Sun-2/50 Video Board Diagnostic. 
The user is required to press the "return" key after entering one of the command 
lines. 

1) If "video50.diag" resides on a SCSI tape, use the command line listed below. 

"b st()" 

2) If "video50.diag" resides on an archive tape, use the following command line. 

"b ai<)" 

3) If "video50.diag" resides on a tape master, use the command line listed below. 

"b mt()" 

7.2. The User Interface 

The four menus of the Sun-2/50 Video Board Diagnostic's user interface • are presented 
below. Initially, the "main menu" is discussed in the section titled "The Main Menu". Secondly, 
the "control register menu" is presented in the section titled "The Control Register". Thirdly, 
the "serial communication controller menu" is explained in the section titled "The Serial~Com- 
munication Controller". Finally, the "video memory menu" is discussed in the section titled "The- 
Video Memory". , 

7.2.1. The Main Menu 

The Main Menu, shown below, has a total of eleven options. These options are discussed fol- 
lowing the display of the "main menu". Keep in mind that typing the character corresponding to 
an option selects that option, while pressing the "return" key after the option was selected 
invokes the option. 

Where it is appropriate, the time required to run a test is displayed on the menu. For example, 
the time required to run the default test sequence is 2 minutes and~5 seconds. This information 
is shown on the menu in the following shorthand form: "2 m 5 s". The "m" stands for minutes 
while, the "s" corresponds to seconds. 
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Sun-2/50 Video Board Diagnostic REV 1.1 8/5/85 Main Menu 

c - Control Register Menu 

s - Serial Communication Controller Menu 

v - Video Memory Menu 

d - Default Test Sequence 2 m 5 s 

a - Execute All Tests 14 m 22 s 

M - Print Error Messages? 

K - Check Parity? 

1 - Loop 

e - Error Log Display 

h - Help 

q - Quit 

Command ==> 



1. Option "c" on the "main menu" is a navigational command. If option "c" is selected, a 
submenu containing all of the control register tests appears. The "control register 
menu" is discussed later in the section titled "The Control Register". The command line 
syntax for option "c" is shown next. 



Option "c" does not accept any arguments. 

Option "s" on the "main menu" is also a navigational command. If option "s" is chosen, a 
submenu containing the tests specific to the serial communication controller appears. 
The "serial communication controller menu" is presented below in the section titled "The 
Serial Communication Controller". The command line syntax for option "s" is shown 
next. 



Like option "c", option "s" does not accept any arguments. 

3. Option "v" on the "main menu" is still another navigational command. If option "v" is 
selected, a submenu containing all of the video memory tests appears. The "video 
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memory menu" is covered later in the section titled "The Video Memory". The com- 
mand line syntax for option V is shown next. 

tf ft 
V 

Again, like options "c" and V, option "v" does not accept any arguments. 

4. Selecting option "d" on the "main menu" initiates the default test sequence. The default 
test is a "quick and dirty" test. It performs minimal testing of all parts of the three 
functional sections of the Sun-2/50 Video Board Diagnostic. Option "d" does not, how- 
ever, perform an exhaustive test of the Sun-2/50 Video Board. Not all of the baud rates 
are used in testing the serial communication controller and only one video memory test 
is performed. The amount of time required to run the default test is approximately: 2 
minutes and 5 seconds. Specifically, the tests listed below are performed by the default 
test option. 

A. "Memory Test Of The Control Register" - Described in the section titled "The 
Control Register". 

B. "Screen (Display) Enable/Disable Test" - Described in the section titled "The Con- 
trol Register". 

C. "Copy Enable/Disable Test" - Described in the section titled "The Control Regis- 
ter". 

D. "Interrupt Enable/Disable Test" - Described in the section titled "The Control 
Register". 

E. "Jumper Test" - Described in the section titled "The Control Register". 

F. "Serial Communication Controller Test" at a "slow" baud rate (300) - Described in 
the section titled "The Serial Communication Controller". 

G. "Serial Communication Controller Test" at a "fast" baud rate (9600) - Described in 
the section titled "The Serial Communication Controller". 

H. "Constant Pattern Test" in byte mode (write and read bytes) - Described in the 
section titled "The Video Memory". 

I. "Constant Pattern Test" in word mode (write and read words) - Described in the 
section titled "The Video Memory". 

The command line syntax for option "d" is shown next. — 

"d" 
Option "d" does not accept any arguments. 

5. If option "a" on the "main menu" is chosen, all Sun-2/50 Video Board tests are executed 
in sequence. The amount of time required to run all tests is approximately: 14 minutes 
and 22 seconds. Specifically, the tests listed below are performed by the "a" option. 

A. "Memory Test Of The Control Register" - Described in the section titled "The 
Control Register". 

B. "Screen (Display) Enable/Disable Test" - Described in the section titled "The Con- 
trol Register". 

C. "Copy Enable/Disable Test" - Described in the section titled "The Control Regis- 
ter". 



August 5, 1985 Revision A page 6 



Sun Microsystems Sun-2/50 Video Board Diagnostic 

D. "Interrupt Enable/Disable Test" - Described in the section titled "The Control 
Register". 

E. "Jumper Test" - Described in the section titled "The Control Register". 

F. "Serial Communication Controller Test" at baud rate 300 - Described in the sec- 
tion titled "The Serial Communication Controller". 

G. "Serial Communication Controller Test" at baud rate 600 - Described in the sec- 
tion titled "The Serial Communication Controller". 

H. "Serial Communication Controller Test" at baud rate 1200 - Described in the sec- 
tion titled "The Serial Communication Controller". 

I. "Serial Communication Controller Test" at baud rate 2400 - Described in the sec- 
tion titled "The Serial Communication Controller". 

J. "Serial Communication Controller Test" at baud rate 4800 - Described in the sec- 
tion titled "The Serial Communication Controller". 

K. "Serial Communication Controller Test" at baud rate 9600 - Described in the sec- 
tion titled "The Serial Communication Controller". 



L. "Serial Communication Controller Test" afbaud rate 19200 - Described in the sec- 
tion titled "The Serial Communication Controller". 

M. "Serial Communication Controller Test" at baud rate 38400 - Described in the sec- 
tion titled "The Serial Communication Controller". 

N. "Serial Communication Controller Test" at baud rate 76800 - Described in the sec- 
tion titled "The Serial Communication Controller". 

O. "Address Test" in word mode (write and read words) - Described in the section 
titled "The Video Memory". 

P. "Constant Pattern Test" in word mode (write and read words) - Described in the 
section titled "The Video Memory". 

Q. "Random Pattern Test" in word mode (write and read-words) - Described in the 
section titled "The Video Memory". 

R. "Uniqueness Test" in word mode (write and read words) - Described in the section 
titled "The Video Memory". 

S. "Checker Pattern Test" in word mode (write and read words) - Described in the 
section titled "The Video Memory". 

T. "Address Test" in byte mode (write and read bytes) - Described in the section 
titled "The Video Memory". 

U. "Constant Pattern Test" in byte mode (write and read bytes) - Described in the 
section titled "The Video Memory". 

V. "Random Pattern Test" in byte mode (write and read bytes) - Described in the sec- 
tion titled "The Video Memory". 

W. "Uniqueness Test" in byte mode (write and read bytes) - Described in the section 
titled "The Video Memory". 

X. "Checker Pattern Test" in byte mode (write and read bytes) - Described in the sec- 
tion titled "The Video Memory". 
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The command line syntax for option "a" is shown next. 

H If 

a 
Option "a" does not accept any arguments. 

6. Option "M" on the "main menu" specifies whether or not messages are displayed on the 
screen. The command line for setting the message-mode-flag is displayed next. 

"M [0 | 1]" 

The brackets ("[" "]") denote that the argument is optional (not required). The charac- 
ter "J" is a shorthand notation for the English word "or". These two conventions are 
used throughout the Sun-2/50 Video Board Diagnostic. 

Option "M" accepts one argument which can have one of two possible values ("0" or "l"). 
If the user enters "M 0" on the commandjinm message mode is turned off (silentjmode). 
On the other hand, if the user types "M l""~on the command line, message mode is 
turned on (verbose mode). It should be noted that, if the user simply enters "M" on the 
command line, message mode is turned on. By default, message mode is on. \ 

7. Option "K" on the "main menu" specifies whether or not parity checking is performed. 
Parity generation is always on. The command line for setting the parity-checking-flag is 
displayed next. 

"K [0 J 1]" 

Option "K" accepts one argument which can have one of two possible values ("0" or "l"). 
If the user enters "K 0" on the command line, parity checking is not performed. On the 
other hand, if the user types "K 1" on the command line, parity checking is executed. It 
should be noted that, if the user simply enters "K" on the command line, parity checking 
is turned on. By default, parity checking is on. — 

8. Option "1" (the letter ell) on the "main menu" gives the user the opportunity to specify 
the number of times a user-specified sequence of tests is to be executed. For example, 
terminating a command line containing one or more user-specified tests with "1 5" exe- 
cutes all of the tests on that command line five times. The command line for the loop 
option is shown below. 

"1 [loop_count]" 

Option "1" accepts one command line argument. The "loop_count" argument is optional. 
Without it, the test(s) on the command line are performed once. All command lines are 
executed once even if the T option does not appear at the end. Therefore, using the "1" 
option without an argument has no affect. 

The "loop_count" argument specifies, in decimal, the number of times that the command 
line sequence is to be executed. The range of legal numerical values for the 
"loop_count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is 
entered as the "loop_count" argument, the given test sequence, theoretically, runs for- 
ever. With one exception, the asterisk (*) symbolizes "forever" throughout the Sun- 
2/50 Video Board Diagnostic. The only exception to this rule is explained in the section. 
titled "The Serial Communication Controller". 

At this point it is relevant to introduce a special character in the command line 
language. The ";" acts as a separator between commands. For instance, let's assume 
that our goal is to run the default option on the "main menu" five times. In order to 
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accomplish this, we can make use of the loop option (option "1") as follows, 
"d ; 1 5" 

The "d" specifies that the default test sequence is to be run. The ";" separates the "d" 
command from the "I" command. The "1 5" indicates that the command line is to be 
executed five times. In short, the ";" must be used to separate commands. It is not used 
to separate a command from its arguments) and it is not used to separate one argument 
from another. Using the ";" in this manner causes a syntax error. 

One more (unfortunate) rule of the command line language is worth mentioning here. 
Due to an implementation "error" in the Diagnostic stand-alone library, all commands, 
arguments and ";"'s must be separated by, at least, one SPACE character. Thus, "d;l 5" 
is not a correct method of running th£_dsfault test sequence five times. Instead, it 
causes a syntax error. 

9. Option "e" on the "main menu" displays an error log. More specifically, at a maximum, 
the first 100 errors messages of each type recorded by the Sun-2/50 Video Board Diag- 
nostic are printed on the screen. The command line syntax for option "e" is shown next. 

e 

Option "e" does not accept any arguments. The user does, however, have the ability to 
suspend and restart the error log display as they see fit. Pressing any key, except "q", 
suspends the error log display until the user presses another key. If the user presses "q" 
at any time, the error log display is terminated. 

10. If option "h" on the "main menu" is chosen, more detailed user instructions appear on 
the screen. The command line syntax for option "h" is shown next. 

"h" 

Option "h" does not accept any arguments. The "help" screen associated with the "main 
menu" is shown next. 
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Main Menu 



c - Control Register Menu 




c 


s - Serial Communication Controller Menu 




< 


v - Video Memory Menu 




V 


d - Default Test Sequence 


2 


m 5 s d 


a - Execute All Tests 


14 


m 22 s a 


M - Print Error Messages? 




M [0 | 1] 


K - Check Parity? 




- K[0J1] 


1 - Loop 




1 [loop_count] 


e - Error Log Display 




e 


h - Help 




h 


q - Quit 




q 



Command ==> 



11. Finally, option "q" on the "main menu" terminates the Sun-2/50 Video Board Diagnostic. 
The command line syntax for option "q" is shown next. 



Option "q" does not accept any arguments. 



7.2.2. The Control Register 

The control register associated with the Sun-2/50 Video Board holds a total of 16 bits. Gen- 
erally speaking, the control register is used to enable/disable various functions, set the copy 
mode base address and monitor the vertical interrupt status. The processor is able to read the 
contents of the entire control register. It cannot, however, read the high or low byte of the con- 
trol register on an individual basis. The processor is capable of writing to (1) the entire control 
register, (2) the high byte of the control register and (3) the low byte of the control register with 
the following exceptions . Bit 00 and bits 07-12 are not affected by the write operations. The 
control register is located at address 0x020000 (131072). A diagram of the control register fol- 
lows. 
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13 



V 

I 

N 
T 
E 

N 



High Byte 



12 



V 
V 
I 

N 
T 



11 10 09 08 



read 


read 


read 


read 


or 


or 


or 


only 


write 


Witt* 


write 





Configuration 
Jumpers 



Low Byte 



07 06 05 04 03 I 02 01 



OO 



CMBASE 
17 - 22 



readonly 



read 

only — 



read or write 



read 

only 



Two types of tests need to be performed on the control register. The memorability of the 
control register itself must be tested. In addition, the functionality of the control register 
requires testing. 

The Control Register Menu, shown below, has a total of fifteen options. These options are 
discussed following the display of the "control register menu". Again, be aware that typing the 
character corresponding to an option selects that option, while pressing the "return" key after 
the option was selected invokes the option. 

Where it is appropriate, the time required to run a test is displayed on the menu. For example, 
the time required to run the default test sequence is 53 seconds. This information is shown on 
the menu in the following shorthand form: "53 s". The "s" stands for seconds. 
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Sun-2/50 Vide 


o Board Diagnostic REV 1.1 8/5/85 


Control Register Menu 




m 


- Memory Test Of Control Register 


9s 




c - 


Copy Enable/Disable Test 


17 s 




M 


- Print Error Messages? 






K 


- Check Parity? 






W 


- Wait (Stop) On Error? 






s - 


Scope Loop On Error? 






s - 


Screen (Display) Enable/Disable Test 


14 s 




i - 


Interrupt Enable/Disable Test 


6s 




J - 


Jumper Test 


9s 




d - 


Default Control Register Test 


53 s 




1 - 


Loop 






e - 


Error Log Display 






h - 


Help 






P - 


Return To The Main Menu 






q - 


Quit 




Command == 


> 







1. The first option on the "control register menu", option "m" performs the memorability 
test of the control register. The goal of the memorability test is to ensure that whatever 
is written to the control register is actually stored there. However, it is not possible to 
test the memorability of the entire control register. In fact, the memorability of only 
bits 01-06 of the control register are tested. The following paragraph explains why. 

To begin with, since bit 00 and bits 07-12 are not writable, the memorability of these 
bits cannot be tested. Secondly, since bit 15 of the control register turns the screen on 
and off, the memorability of bit 15 it not tested. The "Screen (Display) Enable/Disable 
Test", discussed later, indirectly tests the memorability of bit 15 of the control register. 
Thirdly, since bit 14 turns copy-mode on and off, the memorability of bit H is not tested. 
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The "Copy Enable/Disable Test", discussed later, indirectly tests the memorability of bit 
14 of the control register. Finally, since bit 13 of the control register generates video 
board interrupts, the memorability of bit IS is not tested. The "Interrupt 
Enable/Disable Test", discussed later, indirectly tests the memorability of bits 12 and 13 
of the control register. 

The typical testing paradigm consists of the following steps. First of all, a value is writ- 
ten to the control register, bit 00 and bits 07-15 not included. In other words, only bits 
01-06 are written to. Within certain constraints, the user has the ability to specify 
which value(s) are written to the control register. Secondly, the contents of the control 
register are read back. Thirdly, since bit 00 and bits 07-15 are not written to, a masking 
operation is required. Fourthly, the value read back from the control register is com- 
pared to the expected value. Finally, a message is printed indicating the success or 
failure of the test. 

The command line syntax for the memorability test is: 

"m [beg_val [end_val]| [inc] [count]". 

Option "m" accepts as many as four arguments. The "beg_val" (beginning hexadecimal 
value), "end_val" (ending hexadecimal value), "inc" (hexadecimal increment) and "count" 
(pass count) arguments are all optional. Arguments "beg_val", "end_val" and "inc" must 
be specified in hexadecimal while, argument "count" must be specified in decimal. 
Notice that, in order to use the "end_val" argument, the "beg_val" is also be required. 
That explains why the string "[end_val]" is contained in the brackets surrounding 
"beg_val". 

By default, the value of argument "beg_val" is 0x00, while the value of argument 
"end_val" is 0x7f. The range of values is constrained by the fact that only bits 01-06 are 
tested. The user is, however, able to request that any value between 0x00 and 0x7f be 
assigned to the "beg_val" and the "end_val" arguments. The only constraint is that the 
value of argument "beg^vaV mutt be lets than or equal to the value of argument 
n end_vat\ 

By default, the value of the "inc" argument is one (0x1). The "inc" argument dictates 
the sequence of values which are written to the control register. For example, given a 
"beg_val" of 0x00, an "end_val" of 0x06 and an "inc" value of 0x02, the following four 
values would be written to bits 01-06 the control register: 0x00, 0x01, 0x02 and 0x03. 

The real power of having the "beg_val", "encLval" and "inc" arguments becomes evident 
when all three arguments are used in combination. In particular, it is possible to toggle 
(clear and set) any of the CMBASE (Copy Mode Base Address bits [bits 01-06]) bits of 
the control register without affecting the remaining bits of the control register. Further- 
more, a group of bits may be manipulated independently of the rest of the control regis- 
ter. Specifying a "beg_val" of 0x00, an "end_val" of 0x7f and an "inc" of 0x01 attempts 
to write all possible addresses to the CMBASE (Copy Mode Base Address bits [bits 01- 
06]) bits of the control register. 

The optional "count" argument specifies the number of times which the memorability 
test is performed. This argument is specified in decimal. By default, the memorability 
test is performed once. The range of legal numerical values for the "count" argument is 
1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as the count argument, 
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the given test runs forever. 

At first glance, it may seem to be redundant to have a "count" argument for the 
memorability test in addition to an "1" (loop) option, discussed later, on the "control 
register menu". However, there is a distinction. The "count" argument indicates the 
number of times that the memorability test is run. The "l" option indicates the number 
of times that the entire command line is executed. For example, the "1 10" option indi- 
cates that the following command line is to be executed ten times. 

"m 0x1 Oxf 0x3 9 ; i ; j ; 1 10" 

For each of the ten invocations of the above command line, the memorability test is to 
be run nine times (with a "beg_val" of 0x1, an "end_val" of Oxf and an "inc" of 0x3) 
while, the interrupt test (discussed later) and the jumper test (discussed later) are to be 
run once. Thus, the memorability test would be run a total of ninety (90) times, rather 
than ten. 

Another convention of the command line language should be made clear at this point. 
Let's say that we would like to run the memorability test seven times with the default 
values for the "beg_val", "end_val" and "inc" arguments. Simply entering "m 7" would 
not be sufficient. Such a command would run the memorability test once with the ini- 
tial value of "beg_val" equal to seven (7). In order to accomplish our goal, the following 
command line should be entered. 



m 



r 



The "." (period) is another special character within the command line language. It 
causes the default value of an argument to be assigned to that argument. In a sense, the 
"." acts as a place holder. It informs the command line interpreter that the "7" is to be 
assigned to the "count" argument rather than to one of the other arguments. You can 
think of the "." as meaning DEFAULT. 

Within reason, error checking is performed on the command line arguments. 
Specifically, the following checks are performed. 

A. The value of the "beg_va!" is checked. 

B. The value of the "encLval" is checked. 

C. The value of the "inc" is checked. 

D. The value of the "count" is checked. 

E. A check is performed to prevent overflow from occurring. 

2. The second option on the Control Register Menu, option "c", executes the "Copy 
Enable/Disable Test". This test determines whether or not writing to a main memory 
shadow buffer also affects the video memory given the proper conditions. That is, 
whether or not the contents of the main memory shadow buffer are written to the video 
memory and, subsequently, are displayed on the screen given the proper conditions. 

According to the "Theory of Operation Manual for the Sun-2/50 Video Board", the con- 
tents of the main memory shadow buffer are written to the video memory and, subse- 
quently, are displayed on the screen if the following two conditions are met. 

A. The address contained in bits 01-06 of the control register must match the address 
on bus lines 17-22. 
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B. Bit 14 of the control register must be set. 

Independent of whether or not the address contained in bits 01-08 of the control register 
matches the address on bus lines 17-22, the copy operation is not performed if bit 14 of 
the control register is clear. Also, no communication between the video board and the 
CPU takes place if the address contained in bus lines 17-22 does not match the address 
in bits 01-06 of the control register. 

In particular, the following steps are performed when the Copy Enable/Disable Test is 
executed. 

A. Bit 14 of the control register (VCOPYEN) is set. 

B. The address of the first word in the main memory shadow buffer is written to bits 
01-06 of the control register (CMBASE bits: Copy Mode Base Address bits). 

C. A value is written to each word in the main memory shadow buffer. The contents of 
the main memory shadow buffer should consequently appear* on the screen. The 
user has the opportunity to specify the range of values which are written to the 
main memory shadow buffer. 

D. Bit 14 of the control register is cleared. 

E. The contents of the video memory and the main memory shadow buffer are com- 
pared. 

F. The success or failure of the comparison operation is displayed on the screen. 

The command line syntax for the Copy Enable/Disable Test is: 

"c [beg_val [end_val]] [inc] [count]". 

Option "c" accepts as many as four arguments. The "beg_val" (beginning hexadecimal 
value), "end_var (ending hexadecimal value), "inc" (hexadecimal increment) and "count" 
(pass count) arguments are all optional. Arguments "beg_val", "encLval" and "inc" must 
be specified in hexadecimal while, argument "count" must be specified in decimal. 
Notice that, in order to use the "end_val" argument, the "beg_val" is also required. 
That explains why the string "[end_val]" is contained in the brackets surrounding 
"beg_val". 

By default, the value of the "beg_val" argument is 0x0000, while the value of the 
"end_val" argument is Oxffff. The range of values is constrained by the fact that there 
are only 16 bits in a word. The user can, however, request that any value between 
0x0000 and Oxffff be assigned to the "beg_val" and the "encLval" arguments. The only 
constraint is that the "beg_var must be lest than or equal to the n end_var. 

By default, the value of the "inc" argument is one (0x1). The "inc" argument dictates 
the sequence of values which are written to the control register. For example, given a 
"beg_val" of 0x0000, an "end_val" of 0x0006 and an "inc" value of 0x0002, the following 
sequence would be repeated throughout the main memory shadow buffer: "0x0000 0x0002 
0x0004 0x0006". 

The optional "count" argument specifys the number of times which the Copy 
Enable/Disable Test is performed. This argument is specified in decimal. By default, 
the test is performed once. The range of legal numerical values for the "count" 
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argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as the 
count argument, the given test runs forever. 

Although it may seem to be redundant to have a "count" argument for the Copy 
Enable/Disable Test in addition to an "1" (loop) option, discussed later, on the "control 
register menu". There is a useful distinction, however. The "count" argument indicates 
the number of times that the Copy Enable/Disable Test is run. The "1" option indicates 
the number of times that the entire command line is executed. For example, the "I 10" 
option indicates that the following command line is to be executed ten times. 

"c 0x1 Oxff 0x4 8 ; m . . . 3 ; 1 10" 

For each of the ten invocations of the above command line, the Copy Enable/Disable 
Test is to be run eight times (with a "beg_val" of 0x1, an "encLval" of Oxff and an "inc" 
of 0x4) while, the memorability test (discussed earlier) would be run three times. Thus, 
Copy Enable/Disable Test would be run a total of eighty (80) times, rather than ten. 

For the sake of an example, let's say that our goal is to run the Copy Enable/Disable 
Test twice with the default values for arguments "beg_val", "end_val" and "inc". Enter- 
ing "c 2" would not be sufficient. Such a command would run the Copy Enable/Disable 
Test once with the initial value of argument "beg_val" equal to two (2). In order to 
accomplish our goal, the following command line should be entered. 

"c . . . 2" 

The "." (period) is special character within the command line language. Its affect is to 
assign the default value of an argument to that argument. Therefore, the "." acts as a 
sort of place holder. It informs the command line interpreter that the "2" is to be 
assigned to the "count" argument rather than to one of the other arguments. The "." 
means DEFAULT. 

Within reason, error checking is performed on the command line arguments. 
Specifically, the following checks are performed. 

A. The value of the "beg_val" is checked. 

B. The value of the "end_val" is checked. 

C. The value of the "inc" is checked. 

D. The value of the "count" is checked. 

E. A check is performed to prevent overflow from occurring. 

3. The third option on the "control register menu", option "M", specifies whether or not 
messages are displayed on the screen. The command line for setting the message-mode- 
flag is displayed next. 

"M [1 | 0]" 

Option "M" accepts one argument which can have one of two possible values ("0" or "1"). 
If the user enters "M 0" on the command line, message mode is turned off (silent mode). 
On the other hand, if the user types "M 1" on the command line, message mode is 
turned on (verbose mode). It should be noted that, if the user simply enters "M" on the 
command line, message mode is turned on. By default, message mode is on. 
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4. The fourth option on the Control Register Menu, option "K", specifies whether or not 
parity checking is performed. Parity generation is always on. The command line for 
setting the parity-checking-flag is displayed next. 

"K [0 | 1]" 

Option "K" accepts one argument which can have one of two possible values ("0" or "1"). 
If the user enters "K 0" on the command line, parity checking is not performed. On the 
other hand, if the user types "K 1" on the command line, parity checking it executed. It 
should be noted that, if the user simply enters "K" on the command line, parity checking 
is turned on. By default, parity checking is on. 

5. The fifth option on the Control Register Menu, option "W (wait/stop on error), specifies 
whether or not the program is temporarily suspended upon the occurrence of a memory 
data error (not all types of errors). The command line for setting the wait-on-error— flag 
is displayed next. 

"W [0 j 1]" 

Option "W accepts one argument which can have one of two possible values ("0" or 
"1"). Entering "W 0" on the command line means that the program is not suspended 
after the occurrence of a memory data error. If "W 1 M was entered on the command 
line prior to the occurrence of a memory data error, the program waits until the user 
presses any key before continuing. It should be noted that, if the user simply enters "W" 
on the command line, the wait^on-error-flag is turned off. By default, the wait-on-error- 
flag is off. 

Given that the program is waiting for the user to press any key and the user presses "q" 
(a mnemonic for quit), the currently running test is terminated. If, on the other hand, 
the user presses any other key, the memory test continues with the next address. By 
default, the wait-on-error flag is off. 

4. The sixth option on the "control register menu", option "S" (scope loop on error), deter- 
mines whether or not the program enters a scope loop upon the occurrence of a memory 
data error (not all types of errors). If the diagnostic enters a scope loop, it continues to 
write a value to the address in question and read back that value before comparing the 
expected and observed values (i.e the test performs write-read-compare cycles). The 
command line for setting the scope-loop-on-error— flag is displayed next. 

"S [0 j 1]" 

Option "S" accepts one argument which can have one of two possible values ("0" or "1"). 
Entering "S 0" on the command line means that the program does not enter a scope loop 
following the occurrence of a memory data error. If "S 1" is entered, the program does 
enter a scope loop following the occurrence of a memory data error. It should be noted 
that, if the user simply enters "S" on the command line, the scope-loop-on-error-flag is 
turned off. By default, the scope-loop-on-error flag is off. 

The user is able to terminate a scope loop on a particular address by pressing "n" (a 
mnemonic for next address). They can also terminate the scope loop and the currently 
running memory test by pressing "q" (a mnemonic for quit). 

It should be noted that the user can turn both the wait-on-error-flag and the scope-loop- 
on-error-flag on simultaneously. Thus, it is possible to suspend the diagnostic after each 
write-read-compare cycle within the scope loop. Again, the user is able to terminate a 
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scope loop on a particular address by pressing "n" (a mnemonic for next address). They 
are also able to proceed from one write-read-compare cycle to the next by pressing any 
character except 'q' and Yi\ Finally, the scope-loop, wait-on-error condition and the 
currently running memory test can be terminated by pressing "q" (a mnemonic for quit). 
By default, the scope-loop-on-error flag and the wait-on-error flag are off. 

7. Option "s" on the Control Register Menu initiates the Screen (Display) Enable/Disable 
Test. This test aids the user in determining whether or the video display (screen) can be 
turned on and off. In particular, if bit 15 (VIDEN) of the control register is set (equal to 
1), the video display should be on (white with black characters). If bit 15 (VIDEN) of 
the control register is clear (equal to 0), the video display should be off (black). 

The Screen (Display) Enable/Disable Test turns the video display off and then back on. 
Unfortunately, the user is required to watch whether or not the video display flashes off 
and then back on. After the video display is turned back on, a statement appears on 
the screen informing the user that the screen should have just blinked off and then back 
on. However, to eliminate the requirement of user input, the statement does NOT 
require a response. It simply remains on the screen for few seconds before the Sun-2/50 
Video Board Diagnostic continues execution. 

The command line syntax for the Screen (Display) Enable/Disable Test is: 

"s [count]". 

Option "s" accepts one argument. The optional "count" argument specifys the number 
of times which the Screen (Display) Enable/Disable Test is performed. This argument is 
specified in decimab: By default, the test is performed once. The range of legal numeri- 
cal values for the "count" argument is 1 to 2147483647 (0x7fffffff). However, if an aster- 
isk (*) is entered as the count argument, the given test runs forever. Error checking is 
performed on the value entered for the "count" argument. 

8. Chosing option "i" on the Control Register Menu executes the Interrupt Enable/Disable 
Test. The Interrupt Enable/Disable Test tests the video board's ability to interrupt the 
CPU. 

Specifically, the following steps are performed when the Interrupt Enable/Disable Test is 
initiated. To begin with, bit 13 of the control register (VINTEN) is set. This should, in 
turn, cause a jump to an interrupt handler on the next vertical interval. That is, follow- 
ing the conclusion of the current vertical interval, execution of the interrupt routine 
should begin. The duration of a vertical interval is approximately one-seventieth of a 
second. The interrupt routine performs the following steps. 

A. One of the consequences of setting bit 13 of the control register is that bit 12 of the 
control register (WINT) should also get set on the next vertical interval. That is to 
say, following the conclusion of the current vertical interval, bit 12 of the control 
register should get set. Therefore, the interrupt handler determines whether or not 
bit 12 of the control register is set. If it is not set, an error message to that affect is 
displayed. 

B. Next, the interrupt routine clears bit 13 of the control register to disable the inter- 
rupt.'' 

C. A check is made to ensure that bit 13 of the control register is indeed cleared. 
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D. Again, because manipulation of bit 13 of the control register should be reflected in 
bit 12 of the control register on the next vertical interval, a check is made to deter- 
mine whether or not bit 12 of the control register is clear. Given that bit 12 of the 
control register is not clear, an appropriate error message is displayed. 

E. Finally, a global flag is set to indicate that the interrupt routine was executed. 

Since it is not reasonable to assume that the video board's ability to interrupt the CPU 
is functional, the Sun-2/50 Video Board Diagnostic gives up waiting for the execution of 
the interrupt routine after a approximately one second. This eliminates an infinite loop 
in the case that the video board's interrupt facility is not working correctly. If the inter- 
rupt routine is not executed within the specified amount of time, an error message, is 
printed on the screen. 

The command line syntax for the Interrupt Enable/Disable Test is: 

"i [count]". 

Option "i" accepts one argument. The optional "count" argument specifys the number 
of times which the Interrupt Enable/Disable Test is performed. This argument is 
specified in decimal. By default, the test is performed once. The range of legal numeri- 
cal values for the "count" argument is 1 to 2147483647 (0x7fffffff). However, if an aster- 
isk (*) is entered as the count argument, the given test runs forever. Error checking is 
performed on the value entered for the "count" argument. 

9. If option "j" on the Control Register Menu is selected, the (Configuration) Jumper Test 
is initiated. Quite simply, the Jumper Test displays the contents of bits 08-11 of the 
control register. The contents of the Configuration Jumper Bits are displayed in hexade- 
cimal, decimal, octal and binary. 

The command line for the (Configuration) Jumper Test is: 

"j [count]". 

Option "j" accepts one argument. The optional "count" argument specifys the number 
of times which the Jumper Test is performed. This argument is specified in decimal. 
By default, the test is performed once. The range of legal numerical values for the 
"count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as 
the count argument, the given test runs forever. Error checking is performed on the 
value entered for the "count" argument. 

10. Selecting option "d" initiates the default control register test. Since the five control 
register tests run quickly, all five of them are include in the default control register test 
sequence. Therefore, in this case, the default control register test exhaustively tests the 
control register. The amount of time required to run the default control register test is 
approximately: S3 seconds. The five tests are listed next. 

A. Memory Test Of The Control Register. 

B. Screen (Display) Enable/Disable Test. 

C. Copy Enable/Disable Test. 

D. Interrupt Enable/Disable Test. 

E. Jumper Test. 
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The command line syntax for option "d" is shown next. 

"d" 
Option "d" does not accept any arguments. 

11. Option "1" (the letter ell) on the "control register menu" gives the user the opportunity 
to specify the number of times a user-specified sequence of tests is to be executed. Ter- 
minating a command line containing one or more user-specified tests with "1 11", for 
example, executes all of the tests on that command line eleven times. The command line 
for the loop option is shown below. 

"1 [loop_count]" 

Option "1" accepts one command line argument. The "loop_count" argument is optional. 
Without it, the testes) on the command line are performed once. All command lines are 
executed once even if the "1" option does not appear at the end. Therefore, using the "1" 
option without an argument has no affect. 

The "loop_count" argument specifies, in decimal, the number of times that the command 
line sequence is to be executed. The range of legal numerical values for the 
"loop_count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is 
entered as the "loop_count" argument, the given test sequence, theoretically, runs for- 
ever. With one exception, the asterisk (*) symbolizes "forever" throughout the Sun- 
2/50 Video Board Diagnostic. The only exception to this rule is explained in the section 
titled "The Serial Communication Controller". 

The ";" is a special character in the command line language. It acts as a separator 
between commands. If our goal is to run the default option on the "control register 
menu" five times, the loop option is useful. Rather than entering the "d" command five 
times (d ; d ; d ; d ; d), the following command can be used. 

"d ; 1 5" 

The "d" specifies that the default test sequence is to be run. The ";" separates the "d" 
command from the "1" command. The "1 5" indicates that the command line is to be 
executed five times. In short, the ";" must be used to separate commands. It is not used 
to separate a command from its arguments) and it is not used to separate one argument 
from another. Using the ";" in this manner causes a syntax error. 

Another (unfortunate) rule of the command line language is relevant here. Due to an 
implementation "error" in the Diagnostic stand-alone library, all commands, arguments 
and ";"'s must be separated by, at least, one SPACE character. Thus, "d;l 5" is not a 
correct method of running the default test sequence five times. Instead, it causes a syn- 
tax error. 

12. Option "e" on the "control register menu" displays an error log. Specifically, at a max- 
imum, the first 100 error messages of each type produced by the Sun-2/50 Video Board 
Diagnostic are printed on the screen. Notice that these error messages may not neces- 
sarily be related to the control register. The command line syntax for option "e" is 
shown next. 



Option "e" does not accept any arguments. The user does, however, have the ability to 
suspend and restart the error log display as they see fit. Pressing any key, except "q", 
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suspends the error log display until the user presses another key. If the user presses "q" 
at any time, the error log display is terminated. 

13. If option "h" on the "control register menu" is chosen, more detailed user instructions 
appear on the screen. The command line syntax for option "h" is shown next. 

"h" 

Option "h" does not accept any arguments. The "help" screen associated with the "con- 
trol register menu" is shown next. 



Sun-2/50 Video Board Diagnostic REV 1.1 8/5/85 Control Register Menu 



m - Memory Test Of Control Register 9 s c [beg_val [end_val]] [inc] [count] 



c - Copy Enable/Disable Test 

M - Print Error Messages? 

K - Check Parity? 

W - Wait (Stop)On Error? 

S - Scope Loop On Error? 

s - Screen (Display) Enable/Disable Test 14 s s [count] 

i - Interrupt Enable/Disable Test 6 s i [count] 

j - Jumper Test 

d - Default Control Register Test 

1 - Loop 

e - Error Log Display 

h - Help 

p - Return To The Main Menu 

q - Quit 

Command «==-> 



17 s c [beg_val [encLval]] [inc] [count] 
M [0 J 1] 
K [0 ! 1] 

w [o j i] 

S [0 J 1] 



9 s j [count] 
53 s d 

1 [loop_count] 

e 

h 

P 

q 
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14. If option "p" on the Control Register Menu is executed, the Main Menu appears on the 
screen. In other words, option "p" returns to the Main Menu. This option allows the 
user the ability get back to the "main menu" in the case that they want to go to another 
submenu (i.e. The Video Memory Menu or The Serial Communication Controller 
Menu). The command line syntax for option "p" is shown next. 



Option "p" does not accept any arguments. 

15. Finally, option "q" on the "control register menu" terminates the Sun-2/50 Video Board 
Diagnostic. The command line syntax for option "q" is shown next. 



Option "q" does not accept any arguments. 



7.2.3. The Serial Communication Controller 

A Zilog 8530A serial communication controller (SCC) is used to communicate with the key- 
board and the mouse. The serial communication controller consists of two channels (channels A 
and B). Each channel consists of two 16 bit words. One word is for commands while, the other 
word is for data. 

The starting address for the serial communication controller is 0x7Fl800. Four contiguous 
words on the video board are reserved for the serial communication controller. The addresses of 
those four words are 0x7F1800, 0x7Fl802, 0x7F1804 and 0x7F1806. Words 0x7F1800 and 
0x7F1802 correspond to Channel B of the serial communication controller. Channel B of the 
serial communication controller handles communication with the mouse. Words 0x7F1804 and 
0x7Fl806 correspond to Channel A of the serial communication controller. Channel A of the 
serial communication controller handles communication with the keyboard. This information is 
summarized in the following table. 



ADDRESS: 


FUNCTION: 


Ox7F180O 
Ox7F1802 
0x7F1804 
Ox7F1806 


Channel B commands (mouse) 
Channel B data (mouse) 
Channel A commands (keyboard) 
Channel A data (keyboard) 



The serial communication controller is a byte-oriented device. Data is transferred only on 
the high byte of the data words (data bits 08-15). During a read operation, the low byte contains 
the lower byte of the control register. The contents of the lower byte during a write operation is 
unimportant ("don't care"). This information is summarized in the figure below. 
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Figure 1: Serial Communication Controller 





High Byte 




Low Byte 


15 


14 13 12 11 10 09 


08 


07 06 05 04 03 02 01 00 




SCC read or write data 




write = do not care 
read = lower byte of control register 



The Serial Communication Controller Menu, displayed below, has a total of nine options. 
These options are discussed following the display of the "serial communication controller menu". 
Recall that typing the character corresponding to an option aclecta that option, while pressing 
the "return" key after the option was selected invokes the option. 

Where it is appropriate, the time required to run a test is displayed on the menu. For example, 
the time required to run the default test sequence is 37 seconds. This information is shown on 
the menu in the following shorthand form: "37 s". The "m" stands for minutes while, the "s" 
corresponds to seconds. 
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Sun-2/50 Video Board Diagnostic REV 1.1 8/5/85 Serial Com. Controller Menu 

s - Serial Communication Controller Test 

d - Default Serial Communication Controller Test 37 s 

M - Print Error Messages? 

K - Check Parity? 

1 - Loop 

e - Error Log Display 

h - Help 

p - Return To The Main Menu 

q - Quit 

Command ■==> 



The first option on the Serial Communication Controller Menu, option V, executes the 
internal loopback "Serial Communication Controller Test". This option tests the inter- 
face to the serial communication controller by attempting to write data to one channel 
and read it back through that same channel. By default, all values between 0x00 and 
Oxff inclusive are written to Channel A, read back through Channel A and compared 
before a message indicating the success or failure of the test is printed. Next, all values 
between 0x00 and Oxff inclusive are written to Channel B, read back through Channel B 
and compared before a message indicating the success or failure of the test is printed. 
The range of values written to each channel is limited by the fact that the serial com- 
munication controller is a byte oriented device and that there are only 8 bits per byte. 
In short, both channels are tested with all possible data values. 

The command line syntax for the "Serial Communication Controller Test" is: 

"s [baudrate] [count]". 

Option "s" accepts a maximum of two arguments. The "baudrate" and "count" argu- 
ments are both optional. 

Again, by default, the "Serial Communication Controller Test" writes all possible data 
values to both channels. In addition, if the user does not specify a baud rate on the com- 
mand line, baud rate 300 is used. The legal values for the "baudrate" argument are 
"300", "600", "1200", "2400", "4800", "9600", "19200", "38400", "76800", "." and "*". 
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The numeric baud rate values listed above are self explanatory. The final two baud rate 
values ("." and "*"]~are in need of explanation. Entering the value "." for the baud rate 
will execute the "Serial Communication Controller Test" with the two default baud rates 
of 300 and 9600. Entering the value "*" for the baud rate will perform the "Serial Com- 
munication Controller Test" with all of the baud rates listed above. Therefore, in this 
case, the asterisk (*) takes on the new meaning of all rather than forever. 

The optional "count" argument specifies the number of times which the "Serial Com- 
munication Controller Test" is performed. This argument is specified in decimal. By 
default, the "Serial Communication Controller Test" is performed once. The range of 
legal numerical values for the "count" argument is 1 to 2147483647 (0x7fffffff). However, 
if an asterisk (*) is entered as the count argument, the given test runs forever. The dis- 
cussion under the "m" option of the section titled "The Control Register" explains the 
purpose of having both the "count" argument and the loop option (option "1") presented 
below. 

2. Selecting option "d" on the "serial communication controller menu" initiates the default 
serial communication controller test sequence. The default test sequence is as follows. 
All possible values (0x00 - Oxff) are written to Channel A and read back through Channel 
A before all possible values (0x00 - Oxff) are written to Channel B and read back through 
Channel B. These values are written to both channels at two baud rates. The first baud 
rate is 300 (slow) while, the second baud rate is 9600 (fast). 

The command line syntax for option "d" is shown next. 

"d" 
Option "d" does not accept any arguments. 

3. The third option on the "serial communication controller menu", option "M", specifies 
whether or not messages are displayed on the screen. The command line for setting the 
message-mode-flag is displayed next. 

"M [1 j 0]" 

Option "M" accepts one argument which can have one of two possible values ("0" or "1"). 
If the user enters "M 0" on the command line, message mode is turned off (silent mode). 
On the other hand, if the user types "M 1" on the command line, message mode is 
turned on (verbose mode). It should be noted that, if the user simply enters "M" on the 
command line, message mode is turned on. By default, message mode is on. 

4. The fourth option on the "serial communication controller menu", option "K", specifies 
whether or not parity checking is performed. Parity generation is always on. The com- 
mand line for setting the parity-checking-flag is displayed next. 

"K [0 ! 1]" 

Option "K" accepts one argument which can have one of two possible values ("0" or "l"). 
If the user enters "K 0" on the command line, parity checking is not performed. On the 
other hand, if the user types "K 1" on the command line, parity checking is executed. It 
should be noted that, if the user simply enters "K" on the command line, parity checking 
is turned on. By default, parity checking is on. 

5. Option "1" (the letter ell) on the "serial communication controller menu" gives the user 
the opportunity to specify the number of times a user-specified sequence of tests is to be 
executed. For example, terminating a command line containing one or more user- 
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specified tests with "1 5" executes all of the tests on that command line five times. The 
command line for the loop option is shown below. 

"I [loop_count] M 

Option "1" accepts one command line argument. The "loop_count" argument is optional. 
Without it, the test(s) on the command line are performed once. All command lines are 
executed once even if the T option does not appear at the end. Therefore, using the "1" 
option without an argument has no affect. 

The "loop_count" argument specifies, in decimal, the number of times that the command 
line sequence is to be executed. The range of legal numerical values for the 
"loop_count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is 
entered as the "loop_count" argument, the given test sequence, theoretically, runs for- 
ever. The discussion under the "1" option of the section titled "The Main Menu" pro- 
vides additional details relevant to the usage of the loop option. 

6. Option "e" on the "serial communication controller menu" displays an error log. More 

specifically, at a maximum, the first 100 errors messages of each type recorded by the 

Sun-2/50 Video Board Diagnostic are printed on the screen. Notice that these errors 

may not be related to the serial communication controller. The command line syntax 

for option "e" is shown next. 

« tt 
e 

Option "e" does not accept any arguments. The user does, however, have the ability to 
suspend and restart the error log display as they see fit. Pressing any key, except "q", 
suspends'the error log display until the user presses another key. If the user presses "q" 
at any time, the error log display is terminated. 

7. If option "h" on the "serial communication controller menu" is chosen, more detailed user 
instructions appear on the screen. The command line syntax for option "h" is shown 
next. 

"h" 

Option "h" does not accept any arguments. The "help" screen associated with the "serial 
communication controller menu" is shown next. 
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Sun-2/50 Video Board Diagnostic 


REV 1.1 


8/5/85 


Serial Con: 


u Controller Menu 


s - Serial Communication Controller Test 






s [baudrate] [count] 


d - Default Serial Communication Controller Test 


37 s 


d 


M - Print Error Messages? 








M [0 j 1] 


K - Check Parity? 








K[0J1] 


1 - Loop 








1 [loop_count] 


e - Error Log Display 








e 


h - Help 








h 


p - Return To The Main Menu 








e 


q - Quit 








q 


Command ==> 











8. If option "p" on the Serial Communication Controller Menu is executed, the Main Menu 
appears on the screen. In other words, option "p" returns to the Main Menu. This 
option allows the user the ability get back to the "main menu" in the case that they 
want to go to another submenu (i.e. The Video Memory Menu or The Control Register 
Menu). The command line syntax for option "p" is shown next. 



Option "p" does not accept any arguments. 

9. Finally, option "q" on the "serial communication controller menu" terminates the Sun- 
2/50 Video Board Diagnostic. The command line syntax for option "q" is shown next. 

q 



Option "q" does not accept any arguments. 



7.2.4. The Video Memory 



Addresses 0x000000 (0000000) through OxOlFFFE (131070) encompass the video memory. In 
terms of writing, the processor can write bytes or words. The Sun-2/50 Video Board 
Diagnostic's video memory tests tests the processorVability to write bytes and words. 
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The Video Memory Menu, presented next, has a total of sixteen options. The first five 
options on the menu initiate a particular video memory test. Keep in mind that all five of these 
tests execute the following four steps: (1) write to the video memory, (2) read back the contents 
of the video memory, (3) compare the values read back with the expected value and (4) display a 
message indicating the success or failure of the test. The major difference between the video 
memory tests is that each writes a different type of data to the video memory. Recall that typ- 
ing the character corresponding to an option aclecta that option, while pressing the "return" key 
after the option was selected invokes the option. 

Where it is appropriate, the time required to run a test is displayed on the menu. For example, 
the time required to run the "Checker Pattern Test" in byte mode is 5 minutes and 36 seconds 
while, the time needed to complete the "Checker Pattern Test" in word mode is 2 minutes and 
42 seconds. This, information is shown on the menu in the following shorthand form: "b: 5 m 36 
s, w: 2 m 42 s". The "b" stands for byte mode while, the "w" corresponds to word mode. As on 
other menus, "m" implies minutes while, "s" is a mnemonic for seconds. 
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Video Memory Menu 


a - 


Address Test 


b: 50 5, 


w: 27 s 


c - 


Constant Pattern Test 


b: 25 s, 


w: 16 s 


r - 


Random Pattern Test 


b: 37 s, 


w: 22 s 


u - 


Uniqueness Test 


b: 41 s, 


w: 24 s 


x - 


Checker Pattern Test 


b: 5 m 36 


s, w: 2 m 42 s 


d - 


Default Video Memory Test 


40 s 




M 


- Print Error Messages? 






B - 


Byte Or Word Mode? 






K 


- Check Parity? 






W 


- Wait (Stop) On Error? 






S - 


Scope Loop On Error? 






1 - 


Loop 






e - 


Error Log Display 






h - 


Help 






P - 


Return To The Main Menu 






q - 


Quit 






Command ==»> 







1. If option "a" on the "video memory menu" is selected, the_ M Address Test" is invoked. 
The "Address Test" actually performs two tests of the video memory. In the first test, 
the low order bits of a given address are written to the memory location corresponding 
to that address. In the second test, the ones complement of the low order bits of a given 
address are written to the memory location corresponding to that address. 

The command line syntax for the "Address Test" is: 
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"a [count]". 

Option "a" accepts a maximum of one argument. The optional "count" argument 
specifies the number of times which the "Address Test" is performed. This argument is 
specified in decimal. By default, the "Address Test" is performed once. The range of 
legal numerical values for the "count" argument is 1 to 2147483647 (0x7fffffff). However, 
if an asterisk (*) is entered as the count argument, the given test runs forever. The dis- 
cussion under the "m" option of the section titled "The Control Register" explains the 
purpose of having both the "count" argument and the loop option (option "1") presented 
later. Error checking is performed on the value entered for the "count" argument. 

2. If option "c" on the "video memory menu" is chosen, the "Constant Pattern Test" is per- 
formed. The "Constant Pattern Test" writes a constant pattern throughout video 
memory. The command line syntax for the "Constant Pattern Test" is: 

"c [pattern] [count]". 

Option "c" accepts a maximum of two arguments. The "pattern" argument indicates 
which hexadecimal value is to be written throughout video memory. If byte mode is on, 
the "Constant Pattern Test", by default, writes 0x55 to each byte in the video memory. 
On the other hand, if word mode is on, the "Constant Pattern Test", by default, writes 
0x5555 to each word in the video memory^_The distinction between byte and wordjnode 
is covered below under option "B". Assuming that byte mode has been enabled, the 
legal range of values for the "pattern" argument is 0x00 through Oxff. The legal range of 
values for the "pattern" argument when word mode is active is 0x0000 through Oxffl. 
Error checking is performed on the value entered for the "pattern" argument. 

The optional "count" argument specifies the number of times which the "Constant Pat- 
tern Test" is performed. This argument is specified in decimal. By default, the "Con- 
stant Pattern Test" is performed once. The range of legal numerical values for the 
"count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as 
the count argument, the given test runs forever . The discussion under the "m" option of 
the section titled "The Control Register" explains the purpose of having both the "count" 
argument and the loop option (option "1") presented later. Error checking is performed 
on the value entered for the "count" argument. 

3. Selecting option "r" on the "video memory menu" initiates the "Random Pattern Test". 
The "Random Pattern Test" writes random numbers to the video memory based on a 
"seed" (a number used to generate the first random number). The command line syntax 
for the "Random Pattern Test" is: 

"r [seed] [count]". 

Option "r" accepts a maximum of two arguments. The "seed" argument is the decimal 
value that determines the sequence of random numbers which are written to video 
memory. By default, the seed is the decimal integer seven (7). The user can specify 
any decimal value between and 2147483647 for the seed. 

The optional "count" argument specifies the number of times which the "Random Pat- 
tern Test" is performed. This argument is specified in decimal. By default, the "Ran- 
dom Pattern Test" is performed once. The range of legal numerical values for the 
"count" argument is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as 
the count argument, the given test runs forever. The discussion under the "m" option of 
the section titled "The Control Register" explains the purpose of having both the "count" 
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argument and the loop option (option "1") presented later. Error checking is performed 
on the value entered for the "count" argument. 

4. If option "u" on the "video memory menu" is selected, the "Uniqueness Test" is carried 
out. The "Uniqueness Test" writes a series of unique numbers to the video memory. 
Given the i-th memory location in the video memory, the value that is written to that 
location is inconstant. The command line syntax for the "Uniqueness Test" is: 

"u [constant] [count]" 

Option "u" accepts a maximum of two arguments. The "constant" argument is used in 
determining the values that get written to the video memory. The default value of the 
"constant" argument is one (1). The user is able to specify a different "constant", how- 
ever. Assuming that byte mode has been enabled, the legal range of decimal values for 
the "constant" argument is through 255. The legal range of values for the "constant" 
argument when word mode is active is through 65535. The distinction between byte 
and word mode is covered below under option "B". Error checking is performed on the 
value entered for the "constant" argument. 

The optional "count" argument specifies the number of times which the "Uniqueness 
Test" is performed. This argument is specified in decimal. By default; the "Unique- 
ness Test" is performed once. The range of legal numerical values for the "count" argu- 
ment is 1 to 2147483647 (0x7fffffff). However, if an asterisk (*) is entered as the count 
argument, the given test runs forever. ThT discussion under the "m" option oftEe sec- 
tion titled "The Control Register" explains the purpose of having both the "count" argu=- 
ment and the loop option (option "1") presented later. Error checking is performed on 
the value entered for the "count" argument. 

5. Option "x" on the "video memory menu" invokes the "Checker Pattern Test". Like the 
"Address Test", the "Checker Pattern Test" actually perform multiples tests of the video 
memory. For the sake of notational convenience, let's introduce the following. Given a 
binary pattern y, let y be the ones complement of that binary pattern. For instance, if 
binary pattern y is 0, the ones complement of that pattern (j/) is 1. Initially, the 
"Checker Pattern Test" writes the alternating sequence of "y y" throughout the video 
memory. In the second pass, the "Checker Pattern Test" writes the alternating sequence 
of "y y y y" in the video memory. In the third pass, the "Checker Pattern Test" writes 
the alternating sequence of "y y y y y y n throughout thejrideo memory. This process 
continues until one half of the video memory is filled with y's and the other half is filled 
with y's. 

The command line syntax for the "Checker Pattern Test" is: 

"x [pattern] [count]" 

Option "x" accepts a maximum of two arguments. The "pattern" argument is used in 
determining the values that are written to the video memory. If byte mode is on, the 
default hexadecimal value of the "pattern" argument is OxaO. On the other hand, if 
word mode is on, the default hexadecimal value of the "pattern" argument is OxaOaO. 
The distinction between byte and word mode is covered below under option "B". The 
user is able to specify a different "pattern", however. Assuming that byte mode has been 
enabled, the legal range of hexadecimal values for the "constant" argument is 0x00 
through Oxff. The legal range of values for the "pattern" argument when word mode is 
active is 0x0000 through Oxffff. Error checking is performed on the value entered for the 
"pattern" argument. 



August 5, 1985 Revision A page 31 



Sun Microsystems Sun-2/50 Video Board Diagnostic 

The optional "count" argument specifies the number of times which the "Checker Pat- 
tern Test" is performed. This argument is specified in decimal. By default, the 
"Checker Pattern Test" is performed once. The range of legal numerical values for the 
"count" argument is 1 to 2147483847 (0x7fffffff). However, if an asterisk (*) is entered as 
the count argument, the given test runs forever. The discussion under the "m" option of 
the section titled "The Control Register" explains the purpose of having both the "count" 
argument and the loop option (option "1") presented later. Error checking is performed 
on the value entered for the "count" argument. 

6. Selecting option "d" on the "video memory menu" initiates the default video memory 
test. The default video memory test executes the following two tests. 

A. The "Constant Pattern Test" in byte mode with pattern OxaO. 

B. The "Constant Pattern Test" in word mode with pattern OxaOaO. 

The command line syntax for option "d" is shown next. 

"d" 
Option "d" does not accept any arguments. 

7. The seventh option on the "video memory menu", option "M", specifies whether or not 
messages are displayed on the screen. The command line for setting the message-mode- 
flag is displayed next. 

"M [1 ! 0]" 

Option "M" accepts one argument which can have one of two possible values ("0" or "l 5 ).- 
If the user enters "M 0" on the command line, message mode is turned off (silent mode). 
On the other hand, if the user types "M 1" on the command line, message mode is 
turned on (verbose mode). It should be noted that, if the user simply enters "M" on the 
command line, message mode is turned on. By default, message mode is on. 

8. The eighth option on the Video Memory Menu, option "B", specifies whether the 
memory tests will be executed in byte mode or word mode. That is, whether the proces- 
sor writes, reads and compares bytes or words. The command line for setting the byte- 
or-word-mode-flag is displayed next. 

"B [0 ! 1]" 

Option "B" accepts one argument which can have one of two possible values ("0" or "1"). 
If the user enters "B 0" on the command line, byte mode is turned on. On the other 
hand, if the user types "B 1" on the command line, word mode is turned on. It should be 
noted that, if the user simply enters "B" on the command line, word mode is turned on. 
By default, word mode is active. 

9. The ninth option on the "video memory menu", option "K", specifies whether or not par- 
ity checking is performed. Parity generation is always on. The command line for set- 
ting the parity-checking-flag is displayed next. 

"K [0 J 1]" 

Option "K" accepts one argument which can have one of two possible values ("0" or "l"). 
If the user enters "K 0" on the command line, parity checking is not performed . On the 
other hand, if the user types "K 1" on the command line, parity checking is executed. It 
should be noted that, if the user simply enters "K" on the command line, parity checking 
is turned on. By default, parity checking is on. 
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10. The tenth option on the Video Memory Menu, option "W" (wait/stop on error), specifies 
whether or not the program is temporarily suspended upon the occurrence of a memory 
data error (not all types of errors). The command line for setting the wait-on-error~flag 
is displayed next. 

"W [0 j 1]" 

Option V accepts one argument which can have one of two possible values ("0" or 
"1"). Entering "VV 0" on the command line means that the program is not suspended 
after the occurrence of a memory data error. If "W 1" was entered on the command 
line prior to the occurrence of a memory data error, the program waits until the user 
presses any key before continuing. It should be noted that, if the user simply enters "W" 
on the command line, the wait-on-error-flag is turned off. By default, the wait-on-error- 
flag is off. 

Given that the program is waiting for the user to press any key and the user presses "q" 
(a mnemonic for quit), the currently running test is terminated. If, on the other hand, 
the user presses any other key, the memory test continues with the next address. By 
default, the wait-on-error flag is off. 

11. The eleventh option on the "video memory menu" option "S" (scope bop on error), 
determines whether or not the program enters a scope loop upon the occurrence of a 
memory data error (not all types of errors). If the diagnostic enters a scope loop, it con- 
tinues to write a value to the address hfquestion and read back that value befdnTcom- 
paring the expected and observed values (i.e the test performs write-read-compare- 
cycles). The command line for setting the scope-loop-on-error-flag is displayed, next. 

"S [0 J 1]" 

Option "S" accepts one argument which can have one of two possible values ("0" or "l"). 
Entering "S 0" on the command line means that the program does not enter a scope loop 
following the occurrence of a memory data error. If "S 1" is entered, the program does 
enter a scope loop following the occurrence of a memory data error. It should be noted 
that, if the user simply enters "S" on the command line, the scope-loop-on-error-flag is 
turned off. By default, the scope-loop-on-error flag is off. 

The user is able to terminate a scope loop on a particular address by pressing V (a 
mnemonic for next address). They can also terminate the~5eope loop and the currently 
running memory test by pressing "q" (a mnemonic for quit). 

It should be noted that the user can turn both the wait-on-error-flag and the scope-loop- 
on-error-flag on simultaneously. Thus, it is possible to suspend the diagnostic after each 
write-read-compare cycle within the scope loop. Again, the user is able to terminate a 
scope loop on a particular address by pressing "n" (a mnemonic for next address). They 
are also able to proceed from one write-read-compare cycle to the next by pressing any 
character except 'q' and V. Finally, the scope- loop, wait-on-error condition and the 
currently running memory test can be terminated by pressing "q" (a mnemonic for quit). 
By default, the scope-loop-on-error flag and the wait-on-error flag are off. 

12. Option "1" (the letter ell) on the "video memory menu" gives the user the opportunity to 
specify the number of times a user-specified sequence of tests is to be executed. For 
example, terminating a command line containing one or more user-specified tests with 1 
5" executes all of the tests on that command line five times. The command line for the 
loop option is shown below. 
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"I [loop_count]" 

Option T accepts one command line argument. The "loop_count" argument is optional. 
Without it, the testes) on the command line are performed once. All command lines are 
executed once even if the "1" option does not appear at the end. Therefore, using the "1" 
option without an argument has no affect. 

The "loop_count" argument specifies, in decimal, the number of times that the command 
line sequence is to be executed. The range of legal numerical values for the 
"loop_count" argument is 1 to 2147483647 (0x7flfffff). However, if an asterisk (*) is 
entered as the "loop_count" argument, the given test sequence, theoretically, runs for- 
ever. The discussion under the T option of the section titled "The Main Menu" pro- 
vides additional details relevant to the usage of the loop option. 

13. Option "e" on the "video memory menu" displays an error log. More specifically, at a 
maximum, the first 100 errors messages of each type recorded by the Sun-2/50 Video 
Board Diagnostic are printed on the screen. The command line syntax for option "e" is 
shown next. 



Option "e" does not accept any arguments. The user does, however, have the ability to 
suspend and restart the error log display as they see fit. Pressing any key, except "q", 
suspends the error log display until the user presses another key. If the user presses "q" 
at any time, the error log display is terminat&d. 

14. If option "h" on the "video memory menu" is chosen, more detailed user instruc- 
tions appear on the screen. The command line syntax for option "h" is shown next. 



Option "h" does not accept any arguments. The "help" screen associated with the "serial 
communication controller menu" is shown next. 
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Sun-2/50 Video Board Diagnostic REV 1.1 8/5/85 Video Memory Menu 

a - Address Test 

c - Constant Pattern Test 

r - Random Pattern Test 

u - Uniqueness Test 

x - Checker Pattern Test 

d - Default Video Memory Test 40 s 

M - Print Error Messages? 

B - Byte Or Word Mode? 

K - Check Parity? 

W - Wait (Stop) On Error? 

S - Scope Loop On Error? 

1 - Loop 

e - Error Log Display 

h - Help 

p - Return To The Main Menu 

q - Quit 

Command ==> 



b: 50 s, 


w: 27 s 


a [count] 


b: 25 s, 


w: 18 s 


c [pattern] [count] 


b: 37 s, 


w: 22 s 


r [seed] [count] 


b: 41 s, 


w: 24 s 


u [constant] [count] 


b: 5 m 38 s 


, w: 2 m 42 s 


x [pattern] [count] 


40~s~ - 




d 

M [0 J 1] 

B [0 j 1] 

K[0jl] 

W [0 J 1] 

s [o ! i] 

1 [loop_count] 



p 
q 



15. If option "p" on the Video Memory Menu is executed, the Main Menu appears on the 
screen. In other words, option "p M returns to the Main Menu. This option allows the 
user the ability get back to the "main menu" in the case that they want to go to another 
submenu (i.e. The Serial Communication Controller Menu or The Control Register 
Menu). The command line syntax for option "p" is shown next. 



Option "p" does not accept any arguments. 
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16. Finally, option "q" on the "video memory menu" terminates the Sun-2/50 Video Board 
Diagnostic. The command line syntax for option "q" is shown next. 

ft n 

q 

Option "q" does not accept any arguments. 

8. Summary 

In conclusion, this document explained how the user loads and operates the Sun-2/50 Video - 
Board Diagnostic. The command line syntax for each and every menu option was presented. 
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